iShell Help
Tribeworks > iShell > Help >
  String and its Functions
   

A string stores any combination of text, numbers or characters. iShell does not have a way to represent hidden characters such as tabs and returns in a string.

Set String Functions These are used with the Set command.
  • Append: Adds the value of the string on the right to the value of the left.
  • Escape URL: Encodes the values of all special characters to their hexadecimal equivalent. This is the way web servers expect to have data sent.
  • Insert: Inserts a string of code at a specific location in the string. The code can either be inserted before the point, or after the point.
  • Lower Case: Changes the case of all upper case characters to their lowercase equivalent.
  • Remove: Removes a set of characters from the string. The characters can be at the beginning, the end or in between. From specifies the first character to remove and To specifies the last character to remove. If you are removing from the beginning or the end, all that is needed is the number of characters to remove.
  • Replace: Allows a specific part of the string to be replaced with the replacement string. Case sensitive checks to make sure the case is the same when searching for the string to replace.
  • Reverse: Changes the order of the string. The first character becomes the last and the last character becomes the first, etc.
  • Take: Creates a new string with the values of the characters specified in the From to To boxes. Take can also be used on the beginning and end of a string.
  • Trim: Removes a set or specific character from the string. All occurrences of the characters can be removed, All But the characters can be removed, or just the First or Last occurrence can be removed.
  • Upper Case: Converts all lower case characters to upper case characters.
  • Value: Value sets a value to a variable
Get String Functions These are used with the Get command.
  • Value: Value sets a value to the variable.
  • First Index: Returns the position of the first match of the contents in the input field. This can be case sensitive. If there is no match, zero is returned.
  • Last Index: Returns the position of the last match of the contents in the input field. This can be case sensitive. And if no matches are found zero is returned.
  • Length: Returns the length of the string of text.
  • Next Index: Returns the position of the matched input contents after the designated starting position. This can be case sensitive. If no match is found zero will be returned.
  • Previous Index: Returns the position of the matched input contents before the starting position. This can be case sensitive. If no match is found zero will be returned.
Comparison String Functions These are used with the If, Else If, or While commands.
  • Different: The two values are not equal.
  • Equal: The two values are the exactly the same.
  • Less: The first value is less than the second. A is less than B.
  • Less or Equal: The first value is not more than the second.
  • More: The first value is more than the second. B is more than A.
  • More or Equal: The first value is not less than the second.
  • Begin With: Compares the value to the initial part of a string. This can be case sensitive.
  • Contains: Compares the value to see if it is contained in the string. This can be case sensitive.
  • End With: Compares the value to see if it is the last part of the string. This can be case sensitive.